Send Your First API Request

Once your environment is set up, you’re ready to send your first request to the Euclid API. This page covers both GraphQL and REST examples using common tools and languages.

GraphQL Example

Let’s fetch a list of all tokens available through the Euclid router.

GraphQL Query

query Router {
  router {
    all_tokens {
      tokens
    }
  }
}

Example Requests

# index.sh
curl -X POST https://api.euclidprotocol.com/graphql \
  -H "Content-Type: application/json" \
  -d '{"query":"query Router { router { all_tokens { tokens } } }"}'

// App.js
import React, { useEffect } from 'react';
import { ApolloClient, InMemoryCache, HttpLink, gql } from '@apollo/client';

const client = new ApolloClient({
  link: new HttpLink({ uri: 'https://api.euclidprotocol.com/graphql' }),
  cache: new InMemoryCache(),
});

function App() {
  useEffect(() => {
    client
      .query({
        query: gql`
          query Router {
            router {
              all_tokens {
                tokens
              }
            }
          }
        `,
      })
      .then((result) => {
        console.log('API Response:', result.data);
      })
      .catch((error) => {
        console.error('Error:', error);
      });
  }, []);

  return <h1>Check the browser console for the API response</h1>;
}

export default App;

// index.js
const { ApolloClient, InMemoryCache, gql, HttpLink } = require('@apollo/client/core');
const fetch = require('cross-fetch');

const client = new ApolloClient({
  link: new HttpLink({
    uri: 'https://api.euclidprotocol.com/graphql',
    fetch
  }),
  cache: new InMemoryCache(),
});

client.query({
  query: gql`
    query Router {
      router {
        all_tokens {
          tokens
        }
      }
    }
  `
}).then(result => {
  console.log(JSON.stringify(result.data, null, 2));
}).catch(err => {
  console.error('Error:', err);
});

REST Example

Let’s track the status of a transaction on the somnia chain using the REST API.

Endpoint

POST https://api.euclidprotocol.com/api/v1/txn/track

# index.sh
curl -X 'POST' \
  'https://api.euclidprotocol.com/api/v1/txn/track' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "chain": "somnia",
    "tx_hash": "0xe208d710c03d1f7aaed9a0ac9fcd58bdc0c6f3fea5bb074127d10511279545f9"
}'

// index.js
fetch('https://api.euclidprotocol.com/api/v1/txn/track', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'accept': 'application/json'
  },
  body: JSON.stringify({
    chain: 'somnia',
    tx_hash: '0xe208d710c03d1f7aaed9a0ac9fcd58bdc0c6f3fea5bb074127d10511279545f9'
  })
})
  .then(res => res.json())
  .then(data => console.log(data));

// index.js
const axios = require('axios');

axios.post('https://api.euclidprotocol.com/api/v1/txn/track', {
  chain: 'somnia',
  tx_hash: '0xe208d710c03d1f7aaed9a0ac9fcd58bdc0c6f3fea5bb074127d10511279545f9'
}, {
  headers: {
    'Content-Type': 'application/json',
    'accept': 'application/json'
  }
})
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error('Error:', error);
  });

# index.py
import requests

url = "https://api.euclidprotocol.com/api/v1/txn/track"
headers = {
  "accept": "application/json",
  "Content-Type": "application/json"
}
data = {
  "chain": "somnia",
  "tx_hash": "0xe208d710c03d1f7aaed9a0ac9fcd58bdc0c6f3fea5bb074127d10511279545f9"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

# Use this as a Postman raw JSON body

{
  "method": "POST",
  "url": "https://api.euclidprotocol.com/api/v1/txn/track",
  "headers": [
    {
      "key": "Content-Type",
      "value": "application/json"
    },
    {
      "key": "accept",
      "value": "application/json"
    }
  ],
  "body": {
    "mode": "raw",
    "raw": "{\n  \"chain\": \"somnia\",\n  \"tx_hash\": \"0xe208d710c03d1f7aaed9a0ac9fcd58bdc0c6f3fea5bb074127d10511279545f9\"\n}"
  }
}